Documentation Index
Fetch the complete documentation index at: https://wiki.agnes-ai.com/llms.txt Use this file to discover all available pages before exploring further.

Agnes Image 2.1 Flash

升级版图像生成模型，优化高信息密度图像生成，并支持文生图与图生图工作流。

Agnes Image 2.1 Flash 是 Sapiens AI 推出的升级图像生成模型，支持文生图和图生图。相比 2.0 版本，它更适合高信息密度图像、复杂构图和细节丰富的视觉场景。

模型名称

agnes-image-2.1-flash

API Endpoint

POST /v1/images/generations

核心优化

高信息密度图像、复杂视觉细节和语义对齐。

当前价格

生成图像当前为 $0 / 张

概述

Agnes Image 2.1 Flash 可根据文本提示词生成图像，也可基于输入图像进行转换、重绘和风格化编辑。它支持以图像 URL 或 Base64 数据形式返回结果。

高信息密度优化

更适合复杂场景、丰富构图和多层视觉元素。

构图保留

图生图编辑时可尽量保留原始构图和主体布局。

核心能力

文生图

根据自然语言提示词生成高质量图像。

图生图

根据提示词转换或优化现有图像。

高信息密度图像

优化细节丰富、布局复杂、视觉元素密集的图像生成效果。

构图保留

编辑输入图像时保留原始构图和主体布局。

灵活尺寸控制

使用 1K、2K、3K、4K 等尺寸档位，并配合支持的宽高比。

URL / Base64 输出

支持图像 URL 或 Base64 数据返回。

适用场景

创意设计

概念艺术、视觉探索和海报草稿。

营销内容

活动图片、产品视觉和社交媒体创意。

高密度视觉生成

精细场景、复杂环境和丰富构图。

图像转换

风格迁移、场景重打光和背景变换。

产品可视化

产品照片、模型图和商业视觉。

社交媒体素材

封面、横幅、缩略图和帖子图片。

API Reference

Endpoint

POST https://apihub.agnes-ai.com/v1/images/generations

请求头

-H "Authorization: Bearer YOUR_API_KEY"
-H "Content-Type: application/json"

请求参数

参数	类型	必填	说明
`model`	string	是	模型名称，使用 `agnes-image-2.1-flash`。
`prompt`	string	是	图像生成或图像编辑的文本指令。
`size`	string	是	输出尺寸档位。推荐值为 `1K`、`2K`、`3K`、`4K`。也兼容 `1024x768` 这类历史精确尺寸写法，但不支持的尺寸可能会被标准化。
`ratio`	string	否	与档位式 `size` 配合使用的宽高比。支持 `1:1`、`3:4`、`4:3`、`16:9`、`9:16`、`2:3`、`3:2`、`21:9`，默认值为 `1:1`。
`image`	string[]	图生图必填	输入图像数组，支持公共图像 URL 或 Data URI Base64。
`return_base64`	boolean	否	文生图需要以 Base64 返回时使用。
`extra_body`	object	否	高级工作流的附加参数。
`extra_body.response_format`	string	否	输出格式，常见值为 `url` 或 `b64_json`。

尺寸与宽高比

为了获得可预期的输出尺寸，建议将 size 与 ratio 配合使用。

推荐 size 值：1K、2K、3K、4K
支持的 ratio 值：1:1、3:4、4:3、16:9、9:16、2:3、3:2、21:9
如果请求 1920x1080 或 2560x1440 这类不受原生支持的精确尺寸，服务可能会自动映射到最接近的标准档位和宽高比。
如果需要生成 1920x1080 或 2560x1440 这类常见 16:9 显示素材，建议请求 size: "2K" 和 ratio: "16:9"，再在下游裁剪或缩放到最终画布。

1920x1080 和 2560x1440 是标准显示器分辨率，但不是该图像模型的原生输出尺寸。不支持的精确尺寸可能会被标准化，例如映射为 16:9 的 1K 输出尺寸 1312x736。

输出尺寸参考

Ratio	1K	2K	3K	4K
`1:1`	`1024x1024`	`2048x2048`	`3072x3072`	`4096x4096`
`3:4`	`864x1152`	`1728x2304`	`2592x3456`	`3456x4608`
`4:3`	`1152x864`	`2304x1728`	`3456x2592`	`4608x3456`
`16:9`	`1312x736`	`2624x1472`	`3936x2208`	`5248x2944`
`9:16`	`736x1312`	`1472x2624`	`2208x3936`	`2944x5248`
`2:3`	`832x1248`	`1664x2496`	`2496x3744`	`3328x4992`
`3:2`	`1248x832`	`2496x1664`	`3744x2496`	`4992x3328`
`21:9`	`1568x672`	`3136x1344`	`4704x2016`	`6272x2688`

示例：16:9 的 2K 输出

curl https://apihub.agnes-ai.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-image-2.1-flash",
    "prompt": "A cinematic product hero image for a desktop monitor wallpaper, clean lighting, high detail",
    "size": "2K",
    "ratio": "16:9",
    "extra_body": {
      "response_format": "url"
    }
  }'

该请求会返回 16:9 的 2K 档位输出尺寸：2624x1472。

重要说明

请勿在请求体顶层放置 response_format。需要 URL 输出时，请使用 extra_body.response_format: "url"；图生图 Base64 输出请使用 extra_body.response_format: "b64_json"。

文生图

必填参数为 model、prompt 和 size。

尺寸 + 宽高比

使用 2K 等档位式 size，并配合 16:9 等 ratio。

图生图

需要在 extra_body.image 中提供输入图像 URL 或 Data URI Base64。

Base64 输出

文生图可使用 return_base64: true；图生图请使用 extra_body.response_format: "b64_json"。

无需 tags

图生图不需要传递 tags: ["img2img"]。

请求示例

文生图：URL 输出
文生图：Base64 输出
图生图：URL 输出
图生图：Base64 输出
Data URI 输入

curl https://apihub.agnes-ai.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-image-2.1-flash",
    "prompt": "A luminous floating city above a misty canyon at sunrise, cinematic realism",
    "size": "1024x768",
    "extra_body": {
      "response_format": "url"
    }
  }'

返回路径：data[0].url

curl https://apihub.agnes-ai.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-image-2.1-flash",
    "prompt": "A clean product photo of a glass cube on a white studio background, soft shadows, high detail",
    "size": "1024x768",
    "return_base64": true
  }'

返回路径：data[0].b64_json

curl https://apihub.agnes-ai.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-image-2.1-flash",
    "prompt": "Transform the scene into a rain-soaked cyberpunk night with neon reflections while preserving the original composition",
    "size": "1024x768",
    "extra_body": {
      "image": [
        "https://example.com/input-image.png"
      ],
      "response_format": "url"
    }
  }'

返回路径：data[0].url

curl https://apihub.agnes-ai.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-image-2.1-flash",
    "prompt": "Make the object orange while preserving the original composition",
    "size": "1024x768",
    "extra_body": {
      "image": [
        "https://example.com/input-image.png"
      ],
      "response_format": "b64_json"
    }
  }'

返回路径：data[0].b64_json

data:image/png;base64,BASE64_HERE

curl https://apihub.agnes-ai.com/v1/images/generations \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "model": "agnes-image-2.1-flash",
    "prompt": "Make the object matte black while preserving the original composition",
    "size": "1024x768",
    "extra_body": {
      "image": [
        "data:image/png;base64,BASE64_HERE"
      ],
      "response_format": "b64_json"
    }
  }'

响应格式

URL 输出
Base64 输出

{
  "created": 1780000000,
  "data": [
    {
      "url": "https://storage.googleapis.com/agnes-aigc/xxx.png",
      "b64_json": null,
      "revised_prompt": null
    }
  ]
}

{
  "created": 1780000000,
  "data": [
    {
      "url": null,
      "b64_json": "iVBORw0KGgoAAAANSUhEUgAA...",
      "revised_prompt": null
    }
  ]
}

常见错误与故障排除

顶层放置 response_format

错误写法：

{
  "model": "agnes-image-2.1-flash",
  "prompt": "A futuristic city",
  "size": "1024x768",
  "response_format": "url"
}

正确写法：

{
  "model": "agnes-image-2.1-flash",
  "prompt": "A futuristic city",
  "size": "1024x768",
  "extra_body": {
    "response_format": "url"
  }
}

图生图传递 tags

图生图不需要传递 tags: ["img2img"]。只需在 extra_body.image 中提供输入图像。

输入图像 URL 无法访问

请使用公共 HTTPS 图像 URL，并确认不需要登录、cookie 或私有请求头；如果无法公开访问，请使用 Data URI Base64。

请求超时

根据提示词复杂度、图像尺寸和服务器负载情况，图像生成可能需要数秒到几十秒。客户端超时时间建议设置为 60s - 360s。

图生图缺少 image 参数

图生图生成时，extra_body.image 为必填项。

{
  "model": "agnes-image-2.1-flash",
  "prompt": "Make the image cyberpunk style while preserving the original composition",
  "size": "1024x768",
  "extra_body": {
    "image": ["https://example.com/input.png"],
    "response_format": "url"
  }
}

定价

类型	标准价格	当前价格
生成图像	`$0.003 / 张`	`$0 / 张`

接入检查清单

使用 agnes-image-2.1-flash 作为模型名称。

使用 https://apihub.agnes-ai.com/v1/images/generations 作为 API 端点。

文生图请求必须包含 model、prompt 和 size。

为获得可预期的输出尺寸，建议使用 1K 或 2K 等 size 档位，并配合 ratio。

图生图请求需要在 extra_body.image 中提供输入图像。

请勿将 response_format 放在顶层，也不要传递 tags: ["img2img"]。

​Documentation Index

​Agnes Image 2.1 Flash

模型名称

API Endpoint

核心优化

当前价格

​概述

高信息密度优化

构图保留

​核心能力

文生图

图生图

高信息密度图像

构图保留

灵活尺寸控制

URL / Base64 输出

​适用场景

创意设计

营销内容

高密度视觉生成

图像转换

产品可视化

社交媒体素材

​API Reference

​Endpoint

​请求头

​请求参数

​尺寸与宽高比

​输出尺寸参考

​示例：16:9 的 2K 输出

​重要说明

文生图

尺寸 + 宽高比

图生图

Base64 输出

无需 tags

​请求示例

​响应格式

​推荐提示词结构

​常见错误与故障排除

​定价

​接入检查清单

Documentation Index

Agnes Image 2.1 Flash

概述

核心能力

适用场景

API Reference

Endpoint

请求头

请求参数

尺寸与宽高比

输出尺寸参考

示例：16:9 的 2K 输出

重要说明

请求示例

响应格式

推荐提示词结构

常见错误与故障排除

定价

接入检查清单